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Implantation d'un module de codage de reseaux 
dans le simulateur WSNet 

Resume : Ce rapport technique presente Timplantation d'un module de codage 
de reseaux dans le simulateur de capteurs sans-fil WSNet. L'objectif de concep- 
tion de ce module est d'avoir une interface de programmation generique pour 
ensuite specialiser facilement differentes strategies de codage: aleatoire, oriente- 
source/destination, intra/inter-flux, etc. 



Mots-cles : Codage des reseaux, Reseaux de capteurs sans-fil, Simulation, 
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1 Introduction 

Our goal is to study the impact of different Network Coding strategies (NC) on 
end-to-end service delivery over mobile and wireless Disruption- Tolerant Net- 
works (DTNs). To realize this study, in a first step, we simulate a mobile and 
wireless DTN environment. This report presents (i) in section 2, the context: 
DTN, NC and why we have chosen the WSNet simulator, (ii) in section 3, our 
NC framework provided in a WSNet module: architecture, generic API defini- 
tion, packet storing, linear independence checking, real encoding/decoding. 



2 Context 

2.1 Disruption- Tolerant Network 

Disruption- Tolerant Networking (DTN) is an approach that seeks to address the 
non-constant nature of links in networks [2] . This could be caused by mobility 
of the nodes or interference in the environment. 





(a) Nodes connected 



(b) Node moving, 
disconnection 



(c) Node moving, 
reconnection 



Figure 1: Disrupted Network Example 



Figure 1 shows an example of DTN where, as a node moves, the link previ- 
ously established is broken. The link may be established again once the node 
moves back into range of communicating with the original node. Conventional 
routing involves finding a path and forwarding packets from the source to the 
destination. However because of the link break, storing and then forwarding 
when the link is re-established may be needed - so introducing a delay. A com- 
mon approach is to send out replicated packets to many nodes hoping that 
packets will reach the destination. However, this takes up large amounts of 
storage and bandwidth. 

Strategies involving Network Coding are to be accessed to judge their im- 
pacts on delay /tolerance/capacity improvement of a DTN environment [11, 9, 1]. 



2.2 Network Coding 

Network Coding (NC) is a technique where nodes of a network are able to 
combine together two more or received packets and transmit them [4]. With 
enough information - enough encoded packets, the original packets can then 
be decoded at the destination. This is a change from just forwarding packets 
which can bring about potential throughput improvements and a high degree of 
robustness. 

Figure 2 presents the Butterfly Network Coding multicast example. SI and 
S2 are Source nodes, Rl and R2 are Relay nodes, Dl and D2 are Destination 
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Figure 2: Network Coding Butterfly Example 



nodes and xl and x2 are packets from SI and S2 respectively. Dl and D2 needs 
to receive both xl and x2 packets. In the traditional packet sending method, 
xl would be sent to Dl from SI directly. But due to distance from D2, SI will 
send xl via Rl to R2 and then to D2. The same case is for S2 and Dl. Rl 
forwards the whole packet xl then x2, to R2 which then forwards it to Dl and 
D2. Using NC, when Rl receives both xl and x2, Rl can combine the packets 
and send only one packet combining both xl and x2 to R2 which forwards it to 
Dl and D2. Dl and D2 use this encoded packet to retrieve the other missing 
packet. In this case, NC thus helps in reducing the sending of a second packet 
from Rl and R2. 

According to the network topologies considered (linear vs non-linear, mul- 
ticast vs no n- multicast, directed vs undirected, cyclic vs acyclic), different NC 
strategies exist to select and encode packets [7]: random, unique/multi source- 
oriented, unique/multi destination-oriented, intra-session, inter-session, etc. We 
plan to develop and test social and service-oriented NC strategies and so we need 
a realistic simulation environment to compare them in a mobile and wireless 
DTN. 



2.3 WSNet Simulator 

WSNet is a simulator for large-scale Wireless Sensor Networks created and 
developed at the CITI Laboratory [3]. While several simulator exist for 
DTN [10, 8], WSNet main features - Node Simulation, Environment Simula- 
tion, Radio Medium Simulation and Extensibility - are particularly suitable 
for our NC testing. Radio medium simulation provides realistic radio chan- 
nel modeling appropriate to test wireless communication in mobile DTN. Node 
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Simulation allows the integration of the application level, suitable to test social 
and service-oriented NC strategies. 
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Figure 3: Modular Architecture of a WSNet Node 



Figure 3 describes a node architecture that can be created in WSNet. There 
are already various standing modules that can be used for each part: support 
for complex nodes architecture (MIMO systems, multiple radio/antenna inter- 
face support), support for energy consumption simulation, support for various 
propagation models, support for propagation delays, etc. Modules are attached 
on run time and an XML file is used to control the WSNet. 



3 A Generic Network Coding Module in WSNet 
3.1 Module Configuration 

Using the WSNet extensibility feature [5], we have developed an application 
module that simulates a wireless DTN with NC by storing, selecting/dropping, 
encoding/decoding IP packets. 
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Figure 4: Network-Coding Module in WSNet 
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We configure and test it witli different existing WSNet modules [6] (cf Fig- 
ure 4 and Listing 1). No routing module has currently been used since a static 
one, with the Butterfly example, was applied. 



<! — == RADIO and ANTENNA ^=^^===^=^= — > 
<entity name=" omnidirectionnal " library=" antenna_omnidirectionnal "> 

<default loss="0" angle —xy=" random " angle —z=" random " /> 
</ entity> 

<entity name="radio" 1 i br ar y = " radio _ half Id "> 

<default sensibility = "-92" T_b="727" dBm="10" channel="0" 
modulation=" none " /> 
</ entity> 

<! — == MAC = — ^> 
<entity name="mac" library="mac_dcf_802_ll "> 

</ entity> 

<! — == APPLICATION = — > 

<entity name=" EsourceO " li b r ar y=" application_DTNNC_Source "> 

<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPacketf^" 100 " number Of Coefficient s = " 2 " FPower= 
"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chance OfSending=" 10 " /> 
<default type="0" nodenum="0" period="2s" inData=" 15 " /> 
</ entity> 

<entity name=" Esourcel " 1 i b r ar y=" application_DTNNC_Source "> 

<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPacketf^" 100 " numberOf Coefficients = " 2 " FPower= 
"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chanceOf Sending=" 10 " /> 
<default type="0" nodenum=" 1 " period="2s" inData=" 15 " /> 
</ entity> 

<entity name=" EsensorO " 1 i b r ar y=" application_DTNNC_Sensor "> 

<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPackets=" 100 " numberOf Coefficients=" 2 " FPower= 
"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chance Of Sending=" 100 " /> 
<default type="l" nodenum="0" period="2s" inData=" 15 " /> 
</ entity> 

<ent i t y name=" ErelayDumbO " 1 i br ar y = " application_DTNNC_RelayDumb "> 
<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPackets=" 100 " number Of Coefficient s =" 2 " FPower= 
"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chance Of Sending=" 100 " /> 
<default type="3" nodenum=" " /> 
</ entity> 

<entity name=" EsinkO " 1 i br ar y=" application_DTNNC_Sink"> 

<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPacketf^" 100 " number Of Coefficient s =" 2 " FPower= 
"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chanceOf Sending=" " /> 
<default type="2" nodenum=" " /> 
</ entity> 

<entity name=" Esinkl " 1 i br ar y=" application_DTNNC_Sink"> 

<init debugMode=" 1 " dataStruct=" 1 " maxNumberOfCombinedPerPacket=" 
30" maxNumberOfPacketf^" 100 " number Of Coefficient s =" 2 " FPower= 
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"3" storageOrder=" 1 " decodingPolicy=" 1 " encodingType=" 1 " 
encodingPacSelection="l" chance OfSending=" " /> 
<default type="2" nodenum=" 1 " /> 

</ entity> 

Listing 1: DTNNC_Butterfly_example.xml 



3.2 Architecture Overview 

The Figure 5 presents the architecture of the NC module. Each node includes 
the f unctions. h header file, entry point of the framework. This file defines (i) 
the common node structure, variables and data storage - detailed in section 3.3, 
(ii) the common masking/encoding/decoding functions - detailed in section 3.4 
and (iii) useful logging functions - detailed in section 3.5. 




functions.c | 
functions.h | — Pfunction5_log.h 



functions_log.c | 



log_debug.h 
logdebug.c 
I log normal.h | 
log_normal.c 



function5_mask.h 

\ 

functions_mask.c | 

functions_encode.h | 



encodeXOR.h 



functions encode. c 



encode XOR.c 



function5_decode.h decode_gaussian_elimination.h 



functions_decode.c | 1 decode_gaussian_elimination.c~ 



Figure 5: Network-Coding Module Architecture 



3.3 Node Definition 
3.3.1 Node Type 

All common aspects of a node are included in DTNNC_dictionary .h, 
DTNNC_node_structure.h, DTNNC_f unctions . h, DTNNC_f unctions . c and 
DTNNC_dataStorage_hcLndler .h. Each node can then be specialized and in- 
stantiated to be a: 

Source 

• Creates packets 

• Sends packets 
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Sensor 

• Stores received packets 

• Encodes packets, including masking and xor-ing packets 

• Decodes encoded packets, if possible and needed 

• Sends encoded packets out 

RelayDumb 

• Forwards received packets 

Sink 

• Stores received packets 

• Decodes 



3.3.2 Node Common Variable Definitions: dictionary. h 

DTNNC_dictionary .h defines keywords to make code more readable and easier 
to use. 



#ifndef DTNNC_dictionary 

#define DTNNC_dictionary 

/* Node Mode */ 
#define SOURCE 
#define SENSOR 1 
#define SINK 2 
#define RELAYDUMB 3 

/* Log Mode */ 
// change to 1 for debug 
// change to for normal 
#define DEBUG_MODE 1 

/* Debug output prints */ 
#define DEBUG__MASK 
#define DEBUG_DECODEvIG 1 
#define DEBUG_NODE_INFO 1 

/* Debug LogFunction */ 
#define PR]NT_NODE_STORAGE 40 
#define PRINT_DATA_HOLDER 41 
#define PRINT_RECONSTRUCrED_PACKETS 42 

/* LogFunction */ 
#define PRINT_SEND_EVENT 1 
#define PRINT_RECEIVE_EVENT 2 
#define PRINT_STORE_PACKET 3 
#define PRINT_DROP_PACKET_REPEAT 4 
#define PR]NT_DROP_PACKET_DECODED 5 
#define PRINT_IJNEAR_CHECK_FAILED 6 
#define PRINT_LINEAR_CHECK_PASSED 7 
#define PRINT_DECODED 8 
#define PRINT_ENCODED 9 

#define PRINT_UNSErNODE 10 // to be changed to more detailed 
#endif // __DTNNC__dictionary 



Listing 2: DTNNC_dictionary .h 
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3.3.3 Node Structure: node_structure . h 

DTNNC_node_structure . h defines the common structure of all nodes. It is easier 
to edit one structure for all nodes than to make a specific structure for each node 
type. Most variables are needed in all node types. 

#ifndef DTNNC_node_stracture 

#define __DTNNC_node_structure 

/* Node private data */ 
struct nodedata { 

int * overhead ; 

// Source, Sensor, Sink or RelayDumb 
int type ; 

// ID of the node. i.e. node of Source type 
int nodenum ; 

// Flag if Node has decoded packets 
int decodedFlag ; 

int seqNum ; 

// period in which to recall node 
uint64_t period ; 

/* temp data holder */ 

struct packet_data* dataHolder ; 

struct header_packets_combined ** 

dataHolder_ header _ packet s_ combined ; 
uintl6 t dataHolder^numberOfpacketsCombined ; 

int* dataHolder_args ; 

/* data storage */ 

// data storage type Ifbasic arrays) 
struct packet _data * * stored_data ; 
struct header_packets_combined *** 

stored_data_header_packets_combined; 
uintl6_t* stored_data_numberOfpacketsCombined ; 

/* arguments storage */ 
int** stored_data_args ; 

/* reconstructed packets storage */ 

struct packet_data ** reconstructed_pack_data ; 

int** reconstructed_pack_args ; 

/* num of packets stored counter */ 
int num of_packets_stored ; 

/* for stats */ 

// Number of packets transmited by node 
int packet_tx ; 

// Number of packets received by node 
int packet rx ; 

}; 

#endif // DTNNC_node_structure _ 

Listing 3: DTNNC_node_structure . h 



INRIA 



Adding Network Coding Capabilities to the WSNet Simulator 



11 



3.3.4 Node Management Functions: node_f unctions .h 

DTNNC_node_f unctions . h allows to manage a node. It creates the variables, 
allocates the memory for variable structures, and sets the variables to default. 
This API simplifies the development. Editing or adding a new node variable 
requires the editing and adding of this variable in each node type's source code 
file. With this API, it requires to be done only one time in one place. 

#ifndef DTNNC_node_functions 

#define DTNNC_node_functions 

#include " DTNNC_functions . h" 

// Called when setting Node Entity (from int () ) 
int setNodeEntity { call _ t *c , void *params); 

// Called when setting Node Variables (from setnode()) 
int setNodeVariables ( call_t *c , void *params); 

// Called when unsetting node(from unsetnode()) 
// frees memory allocated 
int freeNode ( call _ t *c); 

#endif // _ _DTNNC_node_functions 

Listing 4: DTNNC_node_f unctions .h 



3.3.5 Node Storage: packet. h dataStorage_handler.h 

Data stored are IP packets. These packets are potentially xor-mixed packets, 
so a packet header includes the number and a table of sub-packet headers. A 
final sub-packet header contains an id (can be an application or a service id), 
a sequence number ordering a packet flow, a source and n destinations (for 
broadcast or multicast). Packet data structure contains the real data (here a 
dummy example with 4 characters). 

#i f n d e f DTNNC_node_dummy_packet 

:^define DTNNC_node_dummy_packet 

/* Packet header */ 
struct packet_header { 

struct header_packets_combined ** header_packets_combined_info ; 

uintl6 t numberOfpacketsCombined ; 

uint 1 6 _ t * args ; 

}; 

struct header_packets_combmed { 
uintl6_t seqNum ; 
uintl6_t id ; 
uintl6_t source ; 
uintl6_t numOfDest ; 
uintl6_t * destination ; 

}; 

/ * Dummy 'packet data*/ 
struct packet_data{ 

unsigned char packetdata ; 

unsigned char packetdataB ; 

unsigned char packetdataC ; 
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unsigned char packetdataD ; 

}; 

:^ndif // DTNNC_node_dummy_packet_ 



Listing 5: DTNNC_node_duinmy_packet .h 

DTNNC_dataStorage_handler . h defines generic functions providing the stor- 
age functionality. The data storage structure can easily be changed without 
changing many other code source files. Accessing data is allowed by using get 
and set methods and not accessing to the data directly. 



#i f n d e f DTNNC_dataStorage_handler 

#define __DTNNC_dataStorage handler__ 

#include " DTNNC_functions . h " 

// dataHolder get and set methods 
void* getDataHolderDataAt { call _ t * c); 

void* getDataHolderData packetlnfoAt ( call _ t *c , int positionlnHeader 

); 

int getDataHolder_ number OfpacketsCombinedAt {call_t*c) ; 

int setDataHolderDataAt ( call_t * c, struct packet_data* dataT); 

int setDataHolderData_packetInfoAt ( call_t *c , int positionlnHeader , 
struct header_packets_combined* tempHPC); 

int setDataHolder _numberOfpacketsCombined At ( call _ t *c , int 
numberOfpacketsCombinedIn ) ; 

// datastorage get and set methods 

// Get method to get packet data 

void* getDataAt { call_t * c, int position); 

void* get Data_ packetlnfoAt ( call _ t *c , int positionlnDataStorage , int 
positionlnHeader) ; 

int getData_numberOfpacketsCombinedAt ( call _ t *c , int position); 

// Set method to set packet data 

int setDataAt ( call _ t * c, int position, struct packet_data* dataT); 

int set Data_ packetlnfo At ( call _ t *c , int positionlnDataStorage, int 
positionlnHeader , struct header_packets_combined* tempHPC); 

int setData_numberOfpacketsCombinedAt ( call _ t *c , int position, int 
numberOfpacketsCombinedIn ) ; 

// data Handling functions 

// Generic method to add packet received to storage 
// Gheck if repeat packet is already stored. 
// D efination of non repeat packet is received packet 
// contains an int not found in that column of storage 
// Gheck storage strategy 

int addAllData ( call _ t * c, packet_t * packet); 
// use set methods to add data. 
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// for adding in FIFO other. 

int addAllDataFIFO ( call _ t *c , packet_t *packet); 

// Swap data between 2 specified data in storage 

int swapRowAUData ( call _ t * c, int dataA , int dataB); 

// Reconstructed packet storage get and set methods 

// Get method to get data in reconstructed storage 
void* getRCDataAt ( call _ t * c, int position); 

// Set method to set data in reconstructed storage 

int setRCDataAt ( call_t * c, int position, struct packet_data* dataT) 



#endif // __DTNNC_dataStorage_handler__ 

Listing 6: DTNNC_dataStorage_handler .h 



3.4 Network-Coding API Definition 
3.4.1 Node NC Entry Point: f unctions. h 

DTNNC_f unctions . h header file is the main entry point of our framework and 
connects all other files of the module. It defines the four functionalities of one 
node: storing / dropping / encoding / decoding IP packets. 

Creation of a node only needs to include DTNNC_f unctions .h 



#ifndef DTNNC_functions 

#define DTNNC_functions 

#:include <stdio.h> 

#include <include/ modelutils . h> 

#include " DTNNC_dictionary . h" 
#include " DTNNC_node_structure .h" 
#include " DTNNC_node_entity . li " 
#include "DTNNC_node_dummy packet, h" 

// The headers files below have included this header file 

//#include "DTNNC_ dataStorage_ handler, h " 

//#include " DTNNC_functions_ encode, h " 

//#include " DTNNC_functions_ decode . h " 

//#include " DTNNC _functions_log . h" 

//#include " DTNNC _functions_mask. h " 

/* Functions */ 

/* Encodes packets */ 

// Calls cncodeFunction () from " DTN_functions_ encode . h " 

// which does network coding on two packets depending on policy set 

// Stores resultant packet into dataHolder storage 

int encode ( call _ t * c); 

/* Decodes packets */ 

// Calls decodeFunction () from " DTN_functions_ decode . h " 
// which attempts to do the decoding 

// stores decoded packets into reconstructed packets storage 
int decode ( call _ t * c); 
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/* Stores received packet */ 

// Checks if node has decoded packets, if yes than drop received 
packet 

// Copy received packet to dataHolder storage , This is for sending ( 
read report ) 

// Calls addAllData() from " DTN_ dataStorage_ handler . h " 
// vihich stores the packet data structure 
int store ( call_t * c, packet_t* packet); 

/* Drops packets */ 
// Have not been used 
// Currently empty 
int drop { call _ t * c); 

#endif // DTNNC_functions_ _ 

Listing 7: DTNNC_f unctions .h 



3.4.2 NC Masking: functions_mask.h 

Before combining different packets, a choice of fragmenting data information 
of one packet can be done. Part of the data can be kept and part can be 
'masked'. We use the word 'mask' for the randomly chosen coefficient used 
in the random hnear network coding (p = '^iKPi, with pi the packet frag- 
ments, Xi the coefficients which are referred to in the following as 'masks'). 
DTNNC_functions_mask.h offers this masking function. 

#ifndef DTNNC_functions_mask 

#define DTNNC_functions_mask 

#include " DTNNC_functions . h " 

/* Mask data */ 

// mask data chosen from data structure (dataChoice) 

// vihich holds the column in the matrix ( co ef f i cient C ol ) 

// viith the mask (maskA) 

// input maskA of means a random mask 

int mask(call_t *c , int dataChoice , int c o e f f i c i en t C o 1 , int maskA); 

#endif // DTNNC_functions_mask 

Listing 8: DTNNC_functions_mask.h 



3.4.3 NC Masking - one implementation: functions_mask. c 

There are various methods that can be used to mask packet data. Upon con- 
sideration, the method described in Figure 6 is used. 

One additional byte is added to the data packet during the packet memory 
allocation. The purpose is to tackle the problem of improper masking when the 
total bit size of the packet data is not a factor of the mask size. 

Packet data is copied byte by byte into a byte storage (byteStoreA). Data 
in byteStoreA is then transferred bit by bit into a bit storage (bitStoreB). Data 
in bitStoreB is then transferred bit by bit into a FPower/Size of Mask storage 
(fPowerStoreC) (in Figure 6, size of the mask is 3). fPowerStoreC is then masked 
using the selected mask (in Figure 6, the mask is 001). fPowerStoreC is then 
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byteStoreA 

bitStoreB 

fPowerStoreC 

fPowerStoreC 

bitStoreB 

byteStoreA 



mask 
001 



Data Bytes 
17 19 



Additional Byte 



231 



Data Bits 

0001 0001 0001 0011 0000 0011 1110 0111 0000 0000 
Data Bits - Binary to FPower / Size of iviasl< 

000 100 010 001 001 100 000 Oil 111 001 110 000 000 
Data Bits - iviasl<ed 

000 000 000 001 001 000 000 001 001 001 000 000 000 

Data Bits |V|asl<ed - Binary to Original Data Size 

0000 0000 0001 0010 0000 0001 0010 0100 0000 0000 



Data Bytes iviasked 
18 1 



36 



Figure 6: One Data Masking Implementation: One Additional Byte / Byte to 
Bit conversion / Flow masking 



transferred back bit by bit to bitStoreB. bitStoreB is transferred bit by bit 
to byteStoreA. byteStoreA is then copied byte by byte into the dataHolder. 
Finally, the mask is stored into the argument storage of the dataHolder. 



3.4.4 NC Encoding: f unctions_encode .h 

DTNNC_functions_encode .h encodes data depending on an encoding strategy. 

The encodeFunction acts as a controller function. When this function is 
called, it first checks the encoding validity and then calls the real specific en- 
coding function. Currently the checking consists in testing the node role: if the 
node is only a relay, it checks if there is only one packet in storage buffer and 
forwards that packet without changing it; if the node has an encoding role and 
several packets in the buffer, then the real specific encoding function is called. 

#ifndef IJn^C_ENOODE_H_ 
#define DrNNC_ENOODE_H_ 

#include " DTNNC_functions . h" 

// Controller function 

// Encoding takes place according to strategy chosen 
// Checks number of packets stored, if only 1 packet 
than return 

// Checks encoding type chosen and calls function for 
int encodeFunction ( call _ t *c); 

// Specific function 

// Encoding takes place between two specified datas 
// This function is used for swapping data, needed in decoding 
process 

// Checks and encoding type chosen and calls function for encoding 



(i.e. random ) 
in storage 

encoding 
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int encodeF unct io nS pecif ic ( call _ t *c , int sourceDataA , int 
sourceDataB , int destinationData ) ; 

#endif /* DTNNC_ENCVDE_H_ */ 

Listing 9: DTNNC_functions_encode .h 

3.4.5 NC Encoding - one implementation: f uiictions_eiicode . c 

We provide in the module one random XOR encoding implementation in 
DTNNC_encode_XOR.h and DTNNC_encode_XOR. c. Two random packets are cho- 
sen from the stored data in the node. As randO of C is biased, an improved 
version of random is used: seeding of the random number is done at start of 
node setup at init ( ) of each node type. 

#ifndef DrmNC_EN"aDDE_XOR_H_ 
#define ErmNC_ENOODE_XOR_H_ 

#include " DTNNC_functions_encode .h" 

// Encoding using XOR 

// Check encoding strategy and encodes accordingly 
// Result stored in dataHolder 
int encodeXOR ( call _ t *c); 

// Encode choosing 2 random packets in storage 
// Result stored in dataHolder 
int encodeXOR_random { call _ t *c); 

// Encoding using XOR between two specified datas 
// Result stored in dataHolder 

int encodeXORSpecif ic { call _ t *c , int sourceDataA , int sourceDataB , 
int destinationData); 

#endif /* DTNNC_ENCODE_XOR_H_ */ 

Listing 10: DTNNC_encode_XOR.li 

3.4.6 NC Decoding: functions_decode .h 

DTNNC_f unctions_decode .h decodes data following a decoding strategy. 

The decodeFunction acts also as a controller function. It checks linear 
dependency before decoding: it checks if the last received packet contains 
enough relevant new information comparing to existing information in the stor- 
age buffer. If so the decoding testing is applied. 



#ifndef DTONC DECODE H 




#define DTNNC_DE(X)DE_H_ 




#include " DTNNC_functions 


. h" 


// Controller function 




// Decoding takes place a 


ccording to strategy chosen 


int decodeFunction ( call t 


* c ) ; 


#endif /* DTNNC_DECODE_H_ 


*/ 


Listing 11 


DTNNC functions decode. h 
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3.4.7 NC Decoding - one implementation: f unctions_decode . c 

We provide in the module one Gaussian Elimination im- 
plementation in DTNNC_decode_gaussian_elimination.h and 
DTNNC_decode_gaussian_elimination. c (cf Listing 12). The 
linear IndependentCheck function implements the Linear Independence 
Checking; the f orwardSubstitution function implements the first phase of 
the Gaussian method: the Forward Substitution; the reverseElimination 
function implements the second phase of the Gaussian method: the Reverse 
Elimination; the reconstructPacket function finally implements the third 
phase of the Gaussian method and retrieves the original packet. 

#i f n d e f DTNNC_DE(X)DE_GAUSSIAN_ELIMINATION_H_ 
#define DTNNC_DECODE_GAUSSIAN_ELIMINATION_H_ 

#include " DTNNC_functions_decode . h" 

// decoding using the created gaussian elimination method 
// 0) linear independence (return and stop decoding if not 

linearly independent) 
// 1) Forward Substitution 
// 2) Reverse Elimination 
// 3) Reconstruct packet 

int decode _ gaussian _ elimination ( call _ t *c); 

// Forward substitution, step 1 of gaussian elimination 
// Changes the argument matrix 

// Use linear Indep endentCheck () as guard to ensure linear 

independent 
int for wards ubst it ut ion ( call _ t *) ; 

// Reverse elimination , step 2 of gaussian elimination 
int reverseElimination ( call_t *) ; 

// Reconstruction of packet, step 3 of gaussian elimination 

// Store reconstructed packets in reconstruction data holder 

// Node data storage stores the data up to Step2 (data of each bit) 

int reconstructPacket (call_t *) ; 

// Check that the argument matrix is linearly independent 
// Return if non linearly independent 
int linearlndependentClieck ( call_t *) ; 

#endif /* DTNNC_DECODE_GAUSSIAN_ELIMINATION_H_ */ 

Listing 12: DTNNC_decode_gaussian_elimination.h 

We illustrate the Gaussian implementation with an example in Figures 7-14: 
a masking in the finite group has been applied on 2 packets from different 
sources. 

1. Checking Linear Independence 

Checking Linear Independence is basically the same as the Forward Sub- 
stitution process and code. However doing forward substitution corrupts 
the matrix and if the modified matrix is not linearly independent, the 
original matrix cannot be retrieved easily. 

Therefore the first step of checking linear independence phase is to clone 
the matrix into a temporary matrix for testing linear independence. As 
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this is just a checking phase, data is not touched and therefore not cloned. 
Check for Unear independence fails when the matrix lines swap is not 
successful, meaning a triangulation can not be performed. 

2. Forward Substitution 

Figures 7 to 9 show how forward substitution is done. It starts from the 
top of the matrix and works in the binary format (even if the matrix is 
stored in an integer format). 

• Swap phase 

If the first bit of the first column is not at 1, the algorithm finds the 
first row containing this 1 and data of the rows are swapped. 
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Figure 7: First step of Forward Substitution phase 
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• XORing phase 

The algorithm then checks other rows to find if the first bit of the 
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first column is also at 1. Each matching rows are then xor-ed with 
the first swapped row, ensuring that only the first row has the first 
bit positioned to 1. All data of the row are xor-ed as well. 

These Swap phase and the XORing phase are repeated for each row from 
top to bottom until a triangle of 1 is achieved in Figure 9. 
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Figure 9: Final state of Forward Substitution phase 

3. Reverse Elimination 

Figures 10 to 12 show the reverse elimination process. It starts from the 
bottom of the matrix. From the bottom matrix last sub column, rows are 
scanned from bottom to up to ensure only that row is set at 1 in the sub 
column. Should a 1 be found, a XORing phase is applied and that row is 
xor-ed along with its data to remove the 1. The algorithm then proceeds 
on next rows till a diagonal line of 1, like in Figure 12, is achieved. 
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Figure 11: Second step of the Reverse Elimination phase 
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Figure 12: Final state of the Reverse Elimination phase 

4. Reconstruction of packets 

Figure 13 and Figure 14 show how the reconstruction is done. A recon- 
struction packet storage is used to separate the fragmented packets from 
the reconstructed ones (the original data storage may be use later). From 
the top, (size of mask) number of rows are xor-ed to the first packet of 
the reconstruction storage to reconstruct the original packet. The data is 
Xor-ed as well. Then the same process of (size of mask) number of rows 
xor-ing is applied until the end of the matrix. 
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Figure 13: First xor-ings of the Reconstruction phase 
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Figure 14: End of xor-ings, final state of Reconstruction phase 
3.5 Log API Definition 

WSNet produces ASCII prints on standard output. DTNNC_f unctions_log.h 
defines some useful functions for printing out statistics logs and debug outputs. 
DTNNC_functions_log.h includes node common variables outputs: id, position, 
etc. 

#ifndef DTNNC_functions_log 

#define DTNNC_functions_log 

#include " DTNNC_functions . h" 

// generic function 
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// Use dicitonary.h and input at choice 
// Check debug first 

int logFunction { call_t * c, int choice); 

// Check which log chosen 

int logNormal { call _ t * c, int choice); 

// Check which print out chosen 

int logDebug ( call _ t * c, int choice); 

// Function to print out node type 
int print_node_type ( call _ t * c); 

// Function to print out node id 
int print_nodeid ( call_t * c); 

// Function to print out node position 
int print_nodePosition ( call_t * c); 

// Function to print out failure to print log 
// Can add what to print when failed to print log 
// Currenly printing node type id and position 
int pr i nt _ log failed ( call _ t * c , int choice); 

#endif // _ _DTNNC _functions_log_ _ 

Listing 13: DTNNC_fuiictioiis_log.h 



DTNNC_log_normal .h outputs statistics about 'normal' events of the Net- 
work Coding module use: number of packets received/ sent, encoding/decoding/ 
linear checking, etc. 



#ifndef DTNNC_log_normal 

#define DTNNC_log_normal 

#include " DTNNC_functions_log . h " 

// print send event 

int print _send_event ( call _ t *) ; 

// print receive event 

int print _ receive _ event ( call _ t *) ; 

// print store event 

int print_store_packet ( call_t *) ; 

// print drop packet event when packet is repeat packet 
int print_drop_packet_repeat ( call_t *) ; 

// print drop packet event when node has already decoded packets 
int print_drop_packet_decoded ( call_t *); 

// print linear check fail event 

int pri nt _ linear _ check _ failed ( call _ t *) ; 

// print linear check pass event 

int print _ linear check passed ( call _ t *); 

// print event that node has decoded packets 
int print_decoded ( call_t *) ; 

// print event that node has encoded packets 
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int print _ encoded { call _ t *) ; 

// print event of destroying or uns ettting node at end of 
simulation 

// may print information like counters and such held in node here 
int print _ unset node { call _ t *) ; 

#endif // DTNNC_log_nonnal 

Listing 14: DTNNC_log_normal.h 

DTNNC_log_debug.h implements debugging log functions. These functions 
print the internal node state. 

#ifndef DTNNC_log_debug 

#define DTNNC_log_debug 



#include " DTNNC_functions_log . h" 

// prints what is in data storage 
int print_node_storage ( call_t *) ; 

// prints what is in data holder 
int print_data_holder ( call_t *) ; 

// prints what is in reconstructed packets 
int print reconstruct ed _ packet s { call _ t *) ; 

#endif // DTNNC_log_debug 



Listing 15: DTNNC_log_debug. h 



Debug outputs are data-packet specific. These functions do not show 
only the packet header but output also the packet data to check its cor- 
rectness. Therefore changing the dummy packet data structure will require 
to reimplement these functions. For instance, such implementation of the 
DTNNC_log_debug.h API needs to be adapted. 

printf("| dataA [%d|, dataB [%d|, dataC [%d|, dataD [%d| \n",(( 
struct packet_data *) getDataAt ( c , i ) )—>packetdata ,(( struct 
packet_data *) getDataAt (c , i ) )—>packetdataB ,(( struct packet_data 

*) getDataAt ( c , i ) )—>packetdataC ,(( struct packet_data *) 
getDataAt (c , i ) )— >packetdataD ) ; 
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4 Conclusion 

This technical report has described the implementation of a Network Coding 
module for Wireless and Mobile DTN in WSNet - a Wireless Sensor Network 
simulator. This module provides a generic framework that includes: 

• Programming Interfaces that defines a generic DTN node and its func- 
tionalities: IP packet storing, selecting/dropping, encoding/decoding. 

• Implementations for the main Network Coding functionalities: random 
selecting, random linear coding over i^2'> , Gaussian Elimination decoding. 

Programming Interfaces has been generically defined to allow an easy spe- 
cialization for future different coding strategies: source/destination-oriented, 
intra/inter-flow, application-oriented, social-oriented. 
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